home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / clipper / ahelp5.zip / AREADME.DOC < prev    next >
Text File  |  1990-11-29  |  6KB  |  129 lines
  1.  
  2.                                        MicroFox
  3.                                        P.O. Box 447
  4.                                        Richfield, OH 44286-0447
  5.                                        U.S.A.
  6.  
  7.  
  8.  Dear User Group Coordinator/Shareware Distributor:
  9.  
  10.  
  11.  As part of a promotional campaign, we are giving you two exciting programs to
  12.  distribute to your membership/customers as shareware: AHELP and HDM.  AHELP
  13.  is a full-featured help system for Clipper applications, and HDM (Hard Disk
  14.  Menu) is an independent menu and utility system.
  15.  
  16.  Both programs are marketed as shareware, members who send in registration
  17.  forms (included on the diskette) and a modest fee will receive additional
  18.  benefits.  This is one way we are marketing the products, and we hope you
  19.  will participate.
  20.  
  21.  Enclosed are brief write-ups of each program, suggested as handouts.
  22.  
  23.  Thank you for your assistance.
  24.  
  25.  
  26.                                        Sincerely,
  27.  
  28.                                        MicroFox Co.
  29.  
  30.  
  31.  
  32.                         Overview of AHELP for Clipper
  33.  
  34.  
  35.  AHELP provides both context-sensitive and generalized help windows for use
  36.  with Clipper applications, either Summer '87 or 5.0.  The shareware version
  37.  enclosed is for Summer '87 and provides the following features:
  38.  
  39.  * You control whether help windows have no border, a single-line border, or
  40.    a double-line border.
  41.  
  42.  * You control whether the cross-bars drawn inside the help windows have no
  43.    line, a single line, or a double line.
  44.  
  45.  * AHELP automatically determines the appropriate intersections.
  46.  
  47.  * You control what colors AHELP will use for the help window border, title,
  48.    content, and highlight bar in the help index window.
  49.  
  50.  * You control whether or not the end user has the ability to create or
  51.    modify help windows.
  52.  
  53.  * You control whether or not the help windows have drop shadows.
  54.  
  55.  * AHELP automatically positions the help window immediately below the screen
  56.    position of the input variable (e.g., a GET variable) if the window will fit
  57.    there; otherwise, the window appears immediately above the input variable.
  58.  
  59.  * AHELP provides a help index; whenever any help window is on the screen,
  60.    the user may press F1 to see the help index.  The help index is another
  61.    window with a scrolling alphabetic listing of help subjects.  The user
  62.    uses the cursor control keys to highlight the subject of interest, and
  63.    presses Enter to see the corresponding help window.  The user may also
  64.    type the first letter of the subject to move the highlight bar immediately
  65.    to the first occurrence of that letter.
  66.  
  67.  * AHELP is sensitive to the Clipper environment.  If the cursor is off when
  68.    help is invoked, it will be off when control returns to your application.
  69.    Conversely, if the cursor is on when help is invoked, it will be on when
  70.    control returns to your application.  The same principle applies to colors,
  71.    function keys, insert status, work area, and the status of SET CONSOLE,
  72.    DELETED, ESCAPE, and SCOREBOARD.
  73.  
  74.  * AHELP does not use any "wait state" commands (READ, WAIT, ACCEPT, INPUT,
  75.    MENU TO), to avoid conflicts with any pending GETs.  It uses the INKEY()
  76.    function for all keyboard input, with two exceptions: it calls DBEDIT() for
  77.    the help index window and MEMOEDIT() for displaying/editing help text.
  78.  
  79.  The last page of the user guide (the .DOC file on the distribution diskette)
  80.  is a registration and order form that the user may send in with a modest fee
  81.  to receive a more advanced version of AHELP for either Clipper Summer '87 or
  82.  5.0 -- or both.
  83.  
  84.  
  85.  
  86.                    Overview of AHELP for Clipper, continued
  87.  
  88.  
  89.  This more advanced version of AHELP adds the following features:
  90.  
  91.  * Network capability.  AHELP opens the help file for shared use only unless
  92.    an update is required.  Then it locks the record long enough for the
  93.    update, and immediately unlocks the record.
  94.  
  95.  * Import help displays from ASCII text files.  During creation of a new help
  96.    display, the user may press F7 to tell AHELP to import one or more lines of
  97.    text from a user-specified file.
  98.  
  99.  * Copy or refer to an existing help display.  During creation of a new help
  100.    display, the user may press F1 to tell AHELP to open the help index window,
  101.    "point" to the desired entry, and use that help display.
  102.  
  103.  * Key word capability.  One or two key words may be specified for each help
  104.    display, and a key word search routine allows lookup by matching against a
  105.    key word prompt.  You control whether or not this feature is enabled.  If
  106.    so, it is activated by pressing F7.
  107.  
  108.  * Change the default screen coordinates of either the edit window or the help
  109.    window in the setup call.
  110.  
  111.  * "Drag" or move the help window around the screen and save its new position.
  112.    You control whether or not this feature is enabled.  If it is enabled, it
  113.    is activated by pressing F5.
  114.  
  115.  * Expand or reduce the size of the help window and save its new shape.  You
  116.    control whether or not this feature is enabled.  If it is enabled, it is
  117.    activated by pressing F6.
  118.  
  119.  Both the move and resize features store the new help window coordinates in the
  120.  help file record, so the window will be opened in its new place or shape when
  121.  recalled.
  122.  
  123.  
  124.  We are very excited about this program; it was introduced earlier this year
  125.  and has received wide acclaim here, in Europe, and from as far away as
  126.  Australia.  We think Clipper developers everywhere should add this powerful
  127.  program to their toolkit.
  128.  
  129.